ITRANS

Section: User Commands (1)
Updated: 1 May 1991
Index Return to Main Contents
 

NAME

itrans - modify input text as directed by an indian language metric file, for the purpose of printing out transliterated indian language documents  

SYNOPSIS

itrans [ -v ] [ -I <ifmfilename> ] [ -P [ -f <fontsize> ] ] [ -i <input file> ] [ -o <output file> ] [ -h|H ]
 

DESCRIPTION

The command

itrans < idoc.itx > idoc.tex

takes the input file idoc.itx and copies it to the output file idoc.tex, after modifying all portions in the input designated as transliterated indian language text. itrans looks for the indian language metric file in the standard places, as defined by the environment variable ITRANSDIRS. Set this variable to the path name(s) where the files devnac.ifm, devnac.afm, devnac.text, itrans.pro, etc are to be found (multiple directory names are separated by the letter ":" --- similar to the PATH environment variable).

 

OPTIONS

The input text may be in TeX format, or just in direct PostScript format. By default, TeX format is assumed. The command line switches are:

-I <devnac.ifm>]
Provide the name of the indian language metric file. The file is named devnac.ifm and usually resides in itrans/lib directory. If this option is not provided, the file name "devnac.ifm" is used.
-P
Overrides the default TeX input assumption, and expects that direct PostScript output has to be produced.
-f <fontsize>
If using the PostScript output version, you may need to specify the font size to use. By default, a 30 point size is assumed. This option may not be really necessary, since you can change font sizes and types as desired in the input text itself, see the sample file flag.ips, and the prologue file itrans.pro, for details regarding changing fonts (you must have some PostScript programming ability to do this).
-i <input filename>
Use this option to provide a input file name, if this option is absent, the input file is assumed to be stdin.
-o <output filename>
Use this option to provide a output file name, if this option is absent, the output file is assumed to be stdout.
-v
Set verbose mode, itrans prints out messages regarding what it is doing. Multiple -v options increase the amount of information dumped to stderr.
-h|H
Help option; prints out a synopsis of the command line arguments to itrans.

 

EXAMPLE USAGE

A large number of sample input documents have been provided, in the itrans/doc directory. Files with names ending in .itx are TeX input files, and files with names ending in .ips are PostScript input files. To print out a file named nehru.itx, the following commands can be used (current directory is assumed to be the itrans/doc directory, and ITRANSDIRS environment variable is assumed to be set correctly):

$ itrans -i nehru.itx -o nehru.tex
$ latex nehru.tex
$ dvips nehru.dvi | lp

To print out a file named flag.ips, use the following commands:


$ itrans -P -f 25 < flag.ips > flag.ps
$ cat ../lib/devnac.text ../lib/itrans.pro flag.ps | lp

The above examples assume that the lp command takes in as input a PostScript file, and prints it on a PostScript printer. You may have to use some other print command to print out the PostScript files generated, see your system administrator for details.

 

FILES

devnac.ifm in the lib directory.
 

SEE ALSO

tex(1), latex(1), dvips(1), afm2tfm(1), the report "Printing Transliterated Indian Language Documents", which describes the use of this package in detail.  

BUGS

See the user manual.  

AUTHOR

Avinash Chopde <avinash@contex.com>


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLE USAGE
FILES
SEE ALSO
BUGS
AUTHOR

This document was created by man2html, using the manual pages.
Time: 15:48:07 GMT, March 23, 2025